Skip to main content

Utiliser l'interface de ligne de commande

Tu peux CODESYS.exe à partir de la ligne de commande, en spécifiant les options et les arguments décrits ci-dessous.

Syntaxe:

<installation folder>CODESYS.exe --<Option>

Note

Si vous avez utilisé le CODESYS Installer pour installer plusieurs CODESYS instances sur votre ordinateur, vous devez alors utiliser le --additionalfolder option pour spécifier l’instance à lancer.

Astuce

Les chemins ou les paramètres d'option contenant des espaces, des signes moins ou des barres obliques doivent être placés entre guillemets simples.

Option : --dossier supplémentaire

S'applique uniquement aux installations réalisées avec le CODESYS Installer:

Si vous avez installé plusieurs instances d'un CODESYS version et que vous souhaitez démarrer l'une des instances à partir de la ligne de commande, alors ce qui suit s'applique : En plus du profil, vous devez également spécifier le chemin absolu du AddionalFolder/<instance name> avec le --additionalfolder option.

Contexte : Le CODESYS Installer crée un AdditionalFolders sous-dossier dans le répertoire d'installation dans le CODESYS dossier. Dans ce dossier, il y a un sous-dossier distinct pour chaque CODESYS instance avec les fichiers individuels pour le profil, les plug-ins et PackageDB. Pour la première instance installée, le sous-dossier est nommé Default. Les instances supplémentaires reçoivent le nom d'installation attribué lors de l'installation.

Vous pouvez voir le chemin absolu à spécifier pour --additionalfolder dans CODESYS Installer lorsque vous cliquez sur le Changement dans la vignette de l'instance concernée. Il est enregistré comme le Emplacement.

Syntaxe:

--additionalfolder=<AdditionalFolders\<instance installation name>>
Exemple 43. Exemple

Deux cas de CODESYS 3.5.18.20 ont été installés sur votre ordinateur avec le CODESYS Installer: un pour les techniciens de service, un pour les développeurs. Vous souhaitez exécuter le Service exemple via un StartServiceScript.py script à partir de la ligne de commande. Pour ce faire, spécifiez l'option --additionalfolder après l'option --profile sur la ligne de commande comme suit :

"C:\Program Files (x86)\CODESYS3.5.18.20\CODESYS\Common\CODESYS.exe" --profile="CODESYS V3.5 SP18 --additionalfolder="C:\Program Files\CODESYS 3.5.18.20\CODESYS\AdditionalFolders\Service"  --runscript="D:\Dokumente\Scripting\StartServiceScript.py"--scriptargs:'username password 3.14 "path=\"C:\temp\\\""'–noUI


Option --culture (langue locale de l'interface utilisateur)

CODESYS est lancé dans la langue nationale spécifiée.

Syntaxe:

--culture=<Culture>

<Culture>: Abréviation usuelle de la langue nationale souhaitée, par exemple de, en, fr, it, es, zh-CHS.

Exemple 44. Exemple

Commencer à partir de CODESYS avec interface utilisateur en anglais :

CODESYS.exe --culture=en


option --profile (CODESYS-Profil)

CODESYS est lancé directement avec le profil spécifié. Si vous CODESYS démarrez sans cette spécification, vous obtenez la boîte de dialogue Choisissez un profil.

Syntaxe:

--profile="<profile name>"

<profile name>: Vous devez spécifier le nom du profil exactement tel qu'il apparaît dans la boîte de dialogue Aide → Informations du système de développement ou dans le menu démarrer de votre ordinateur.

Exemple 45. Exemple
CODESYS.exe --culture=de --profile="CODESYS V3.6"


Option --compare (déclencher la comparaison de projets)

Après être parti de CODESYS devient immédiatement la comparaison de deux CODESYS-Projets réalisés. Entrez d'abord le "projet actuel" puis le "projet de comparaison" comme arguments derrière l'option. CODESYS démarre et ouvre la vue Comparaison de projets - différences.

Syntaxe:

--compare="<path of project file>" "<path of reference project file>"
Exemple 46. Exemple
CODESYS.exe --compare  "D:\proj\project1.project"  "D:\proj\project2.project"


Options --project (CODESYS-projet ouvert)

CODESYS est démarré et le projet spécifié est ouvert.

Syntaxe:

--project="<path of project file>"

<path of project file>: Chemin du fichier du projet

Exemple 47. Exemple

Ouvrir le projet test:

CODESYS.exe --culture=de --project="D:\projects\test.project"


Options --projectarchive (CODESYS- archive de projet ouverte)

CODESYS démarre, extrait le référentiel spécifié et ouvre le projet.

Syntaxe:

--projectarchive="<path of projectarchive file>"

<path of project archive file>: chemin du fichier de référentiel

Exemple 48. Exemple

Extraction de l'archive du projet test.projectarchive et ouvrir le projet dans le système de programmation :

CODESYS.exe --projectarchive="D:\projects\test.projectarchive"


Option --runscript (exécuter le script)

Le fichier de script spécifié est exécuté par CODESYS réalisé.

Tableau 8. Options de ligne de commande pour --runscript

--runscript="<scriptfile>.py"

CODESYS exécute le fichier de script <scriptfile>.py éteint au démarrage.

Vous devez spécifier le chemin d'accès complet du fichier de script.

--scriptargs:'<arg1> <arg2> ... <argn>'

Utilisez l'option avec l'option --runscript. Il provoque le passage des arguments <arg1> … <argn> au script. Les arguments sont passés à la variable Python sys.argv transmis.

--noUI

Utilisez l'option avec l'option --runscript.

la CODESYS L'interface utilisateur ne s'ouvre pas. CODESYS affiche toutes les erreurs, avertissements, messages du compilateur et messages générés par le script sur la ligne de commande. Les messages de script (1 : Severity Text) peuvent être séparés des autres messages (2 : Severity FatalError, Error, Warning, Information) avec l'opérateur > être séparés.

--enablescripttracing

Utilisez l'option avec l'option --runscript. Il fait apparaître chaque commande du fichier de script dans la sortie.

--textPrompts

Utilisez l'option avec l'option --noUI. Il entraîne la sortie des méthodes de service de messagerie et des boîtes de dialogue standard sur la ligne de commande afin que l'entrée de l'utilisateur puisse avoir lieu.

Si vous --textPrompts S'il n'est pas spécifié, toutes les invites du service de messagerie reçoivent automatiquement la valeur par défaut.



Exemple 49. Exemples d'utilisation de paramètres de transfert dans des fichiers de script à l'aide de sys.argv
start /b /wait CODESYS.exe
--runscript="D:\Script\ArgvAnd__main__Test.py"
--scriptargs:'username password 3.14 "path=\"C:\temp\\"'

Fichier de script ArgvAnd__main__Test.py

from __future__ import print_function
import sys
print("sys.argv: ", len(sys.argv), " elements:")

for arg in sys.argv:
    print(" - ", arg)
print()
print("__name__: ", __name__)

résultat de sortie stdout:

sys.argv: 6 elements:
- D:\TestScripts\ArgvAnd__main__Test.py
- username
- password
- 3.14
- path= "C:temp"
__name__: __main__

En savoir plus sur la variable globale __name__ voir la documentation Python.



Exemple 50. Exemples de sortie de message
start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 1>ScriptMessages.txt

Toutes les notifications générées par le script sont acheminées CODESYS dans le dossier ScriptMessages.txt environ. Les autres messages sont affichés dans la ligne de commande.

start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 2>NUL

CODESYS supprime tous les messages à l'exception des messages de script. Les messages de script sont affichés dans la ligne de commande.



Exemple 51. Exemple utilisant l'option –scriptdebugger

Le script suivant initdebug.py a réussi avec pydevddes débogueurs basés sur PyDev / LiClipse ou PyCharm. Pour utiliser ce script, lancez CODESYS avec la ligne de commande suivante :

--profile="Fanta Development Build" --scriptdebugger="D:\test\charmdebug\initdebug.py"

déposerinitdebug.py:

from _future_ import print_function
from _future_ import unicode_literals
import sys
sys.path.append(r"D:\test\Env2\Lib\site-packages\pycharm-debug.egg")
import pydevd
def scriptdebuggersetup():
pydevd.settrace('localhost', port=51234, stdoutToServer=True, stderrToServer=True)
def scriptdebuggershutdown():
pydevd.stoptrace()


Pour plus d'informations, consultez : Utiliser des scripts et http://docs.python.org/tutorial/modules.html

Option : --ignorewhitespace (ignorer les espaces lors de la comparaison de projets)

Si vous mettez cette option derrière l'option --compare <project1> <project2> ajouter, les espaces ne sont pas pris en compte dans la comparaison de projets. Remarque : les espaces sémantiquement pertinents, comme dans STRING-les littéraux sont toujours pris en compte dans tous les cas.

syntaxe

--compare="<path of project file>" "<path of reference project file>" --ignorewhitespace="true"|"false"
Exemple 52. Exemple
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorewhitespace="true"


Option: --ignorecomments (Ignorer les commentaires lors de la comparaison de projets)

Si vous mettez cette option derrière l'option --compare <project1> <project2> ajouter, les commentaires ne sont pas pris en compte dans la comparaison de projets.

Syntaxe:

--compare="<path of project file>" "<path of reference project file>" --ignorecomments="true"|"false"
Exemple 53. Exemple
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorecomments="true"


Option: --ignoreproperties (Ignorer les propriétés de l'objet lors de la comparaison de projets)

Si vous mettez cette option derrière l'option --compare <project1> <project2> add, les propriétés des objets (droits d'accès, paramètres de traduction, répertoires, bitmaps, etc.) ne sont pas prises en compte dans la comparaison de projets.

Syntaxe:

--compare="<path of project file>" "<path of reference project file>" --ignoreproperties="true"|"false"
Exemple 54. Exemple
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignoreproperties="true"


Option: --skipunlicensedplugins (ne charge pas les composants sans licence)

CODESYS a démarré. La question de savoir si les composants sans licence doivent néanmoins être chargés est ignorée. Dans ce cas charge CODESYS implicitement ces composants ne pas.

Exemple 55. Exemple
CODESYS.exe –skipunlicensedplugins


Option: --signaturethumbprint (empreinte du certificat utilisé pour signer les bibliothèques traduites)

Si vous mettez cette option derrière l'option --project="<path of project file>" ajouter, le projet sera ouvert en passant l'empreinte du certificat pour la signature des bibliothèques traduites.

Syntaxe:

--signaturethumbprint="<thumbprint of digital signature>"
Exemple 56. Exemple
CODESYS.exe --project="D:\projects\test.project" signaturethumbprint="3E96C9B61010CBDC3186021A1CAA64946DDCAAF3"


Option : --enforcesignedcompiledlibraries (applique la signature des bibliothèques compilées)

Si vous mettez cette option derrière l'option --project="<path of project file>" add apparaîtra dans le projet dans le écran de sécurité sur l'onglet utilisateur l'option Appliquer la signature des bibliothèques traduites activé.

Important

Si la écran de sécurité est ouvert et refermé, les paramètres actuels sont appliqués aux options utilisateur, même si aucune modification active n'a été apportée.

Syntaxe:

--enforcesignedcompiledlibraries
Exemple 57. Exemple
CODESYS.exe --project="D:\projects\test.library" --enforcesignedcompiledlibraries


Option: --timestampingserverurl (définir l'adresse du serveur d'horodatage)

Si vous mettez cette option derrière l'option --project="<path of project file>" add apparaîtra dans le projet dans le écran de sécurité sur onglet utilisateur l'adresse Internet du serveur d'horodatage RFC-3161 (Serveur d'horodatage) ensemble.

Important

Si la écran de sécurité est ouvert et refermé, les paramètres actuels sont appliqués aux options utilisateur, même si aucune modification active n'a été apportée.

Syntaxe:

--timestampingserverurl="<URL of RFC-3161 timestamping server>"
Exemple 58. Exemple
CODESYS.exe --timestampingserverurl="http://timestamp.comodoca.com/rfc3161"


Option : --enableEventLog

CODESYS est démarré et toutes les exécutions de commandes sont enregistrées dans le journal des événements Windows. Les enregistrements se trouvent dans Windows Observateur d'événements sous Journaux des applications et des services → AP.

Lorsque vous utilisez cette option pour la première fois, CODESYS doit être démarré avec des autorisations d'administrateur.

Syntaxe:

--enableEventLog="CommandManager"

Option : --ForceDisconnectAfterInactivity

Pour ça CODESYS session, le temps d'inactivité après lequel la connexion au contrôleur est automatiquement interrompue est défini sur la durée spécifiée (en secondes). La valeur spécifiée dans cette option remplace la valeur définie dans le CODESYS options dans le En ligne catégorie pour ça CODESYS session.

Si la valeur est définie sur 0, la connexion au contrôleur ne sera pas automatiquement interrompue après une période d'inactivité spécifique. Pour ça CODESYS session, cela désactive l'option de déconnexion dans la CODESYS choix.

Syntaxe:

--ForceDisconnectAfterInactivity="<value in seconds>"
<value in seconds> : [10, 10800] | 0
Exemple 59. Exemple

Après 300 secondes d'inactivité, la connexion au contrôleur est automatiquement interrompue.

--ForceDisconnectAfterInactivity="300"